A_DIMS()
 Return the number of dimensions in an array
-------------------------------------------------------------------------------

 Syntax

    A_DIMS( <aTarget> )   ->   nDimensions

 Arguments

    <aTarget> is the array whose dimensions are being queried.

 Returns

    A_DIMS() returns the number of dimensions of <aTarget>.

 Description

    A_DIMS() is used to query an array returning the number of
    dimensions that were used when the array was A_DECLARE()d.


 Examples

    // Declare a four dimensional (S)tring array
    LOCAL books, pages, rows, cols

    books = 2
    pages = 10
    rows = 15
    cols = 50
    aString = A_DECLARE( "S", books, pages, rows, cols )

    ? A_DIMS( aString )          // Result: 4